.TH E1432_SET_SRCPARM_MODE 3 E1432
.SH NAME
.nf
e1432_set_srcparm_mode \- Set source parameter mode
e1432_get_srcparm_mode \- Get current state of source parameter mode
e1432_update_srcparm \- Update source with current parameters
.fi
.IX e1432_set_srcparm_mode(3) 3
.IX e1432_get_srcparm_mode(3) 3
.IX e1432_update_srcparm(3) 3
.SH SYNOPSIS
.cS
SHORTSIZ16 e1432_set_srcparm_mode(E1432ID hw, SHORTSIZ16 ID,
                                 LONGSIZ32 mode)
SHORTSIZ16 e1432_get_srcparm_mode(E1432ID hw, SHORTSIZ16 ID,
                                 LONGSIZ32 *mode)
SHORTSIZ16 e1432_update_srcparm(E1432ID hw, SHORTSIZ16 ID,
                                 LONGSIZ32 updatemode)
.cE
.SH DESCRIPTION
\fIe1432_set_srcparm_mode\fR sets the source parameter mode, of a single channel
or group of channels \fIID\fR, to the value given in \fImode\fR.

\fIe1432_get_srcparm_mode\fR returns the current value of the source
parameter mode, of a single channel or group of channels \fIID\fR, into a memory
location pointed to by \fImode\fR.

\fIhw\fR must be the result of a successful call to
\fIe1432_assign_channel_numbers\fR, and specifies the group of
hardware to talk to.

\fIID\fR is either the ID of a group of channels that was obtained with a
call to \fIe1432_create_channel_group\fR, or the ID of a single channel.

\fImode\fR determines the source parameter mode when the source is on.
At the start of a measurement with an active source, the source parameters are
sent to the source independent of the \fImode\fR setting.  The \fImode\fR
setting is effective after the start of the measurement.
The valid values are:

\fBE1432_SRCPARM_MODE_IMMED\fR for immediate update of any source
parameter (default),

\fBE1432_SRCPARM_MODE_DEFR\fR all source parameter changes are deferred
until a call to \fIe1432_update_srcparm\fR. 

The source parameters that can be set on the fly (and controlled by
\fImode\fR) are: amp_scale, range, freq, phase (as appropriate for the
source mode).

\fIe1432_update_srcparm\fR updates the source with current parameters values
using the method determined by the value given in \fIupdatemode\fR, for
a single channel or group of channels \fIID\fR.  It is to be called durring
a measurement, after source parameter values are changed, when \fImode\fR
is \fBE1432_SRCPARM_MODE_DEFR\fR.

\fIupdate_mode\fR determines the method used in updating the source
parameters.  \fIupdate_mode\fR is ignored if \fImode\fR is
\fBE1432_SRCPARM_MODE_IMMED\fR.  For all source channels, valid values are:

\fBE1432_SRCPARM_UPDATE_IMMED\fR for parameters changed immediately,
when \fIe1432_update_srcparm\fR is called.

For sine or burst sine source channels, additional valid values are:

\fBE1432_SRCPARM_UPDATE_IMMEDTRGOUT\fR for parameters changed immediately
and send a trigger out (trigger out not sent when source is burst mode),

\fBE1432_SRCPARM_UPDATE_XING\fR for parameters changed at next zero
crossing,

\fBE1432_SRCPARM_UPDATE_XINGTRGOUT\fR for parameters changed at next zero
crossing and send a trigger out (trigger out not sent when source is burst mode),

\fBE1432_SRCPARM_UPDATE_TRGIN\fR for parameters changed at next trigger
(not avaliable on the source daughter board channel),

Obviously, these functions is are not useful when talking to input or tach
channels.  Only source channels have a srcparm mode.
.SH "RESET VALUE"
After a reset, \fImode\fR is set to \fBE1432_SRCPARM_MODE_IMMED\fR.
.SH "RETURN VALUE"
Return 0 if successful, a (negative) error number otherwise.
.ad
